home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / program / assembly / basmify.lha / Basmify / Basmify.doc < prev    next >
Text File  |  1995-09-26  |  4KB  |  113 lines
  1.  
  2.                                   Basmify
  3.                                   =======
  4.                                     1.0
  5.  
  6. Two ARexx scripts for the use of Basm directly from within CygnusED.
  7.  
  8.  
  9.  0. CONTENTS
  10. -------------
  11.  
  12.  1. Disclaimer
  13.  2. Requirements
  14.  3. Installation
  15.  4. Usage
  16.  5. Limitations
  17.  6. Author
  18.  
  19.  
  20.  1. DISCLAIMER
  21. ---------------
  22.  
  23. Copyright (c) 1995 by Ulrich Flegel.
  24.  
  25. Permission  is granted to make and distribute verbatim copies of this manual
  26. provided  the  copyright  notice and this permission notice are preserved on
  27. all copies.
  28.  
  29. No  guarantee  of  any  kind  is  given  that the programs described in this
  30. document  are  100% reliable.  You are using this material at your own risk.
  31. The  author  can  not  be made responsible for any damage which is caused by
  32. using these programs.
  33.  
  34. Permission is granted to include this package in Aminet CD-ROMs.
  35.  
  36. None  of  the programs may be included or used in commercial programs unless
  37. by written permission from the author.
  38.  
  39. None  of  the programs may be modified in any way.  For improvements contact
  40. the author.
  41.  
  42. None  of  the  programs  may  be  used  on any machine which is used for the
  43. research,  development,  construction,  testing  or production of weapons or
  44. other  military  applications.  This also includes any machine which is used
  45. for training persons for any of the above mentioned purposes.
  46.  
  47.  
  48.  2. REQUIREMENTS
  49. -----------------
  50.  
  51. To  work  with  these scripts it is required that you have installed Barfly,
  52. CygnusED 3.0 or newer and last but not least ARexx on your Amiga.
  53.  
  54.  
  55.  3. INSTALLATION
  56. -----------------
  57.  
  58. Copy  the  two  files  'Assemble.ced'  and 'NextError.ced' to any directory.
  59. Assign 'Basmify:' to this directory.  If you don't the scripts will not find
  60. each  other.   Then  you  have  to  change  the  'NextError'  and 'Assemble'
  61. variables in the scripts to fit the pathnames.
  62.  
  63. Adapt  the BAsmPath variable in the 'Assemble.ced' script to the pathname of
  64. the directory where your BAsm is, so BAsm needs not to be in your path.
  65.  
  66. Start  CygnusED  and  assign  the  scripts  to  two  F keys (select the menu
  67. Special,  DOS/ARexx  interface  »  Install  DOS/ARexx cammand...), let's say
  68. 'NextError.ced' to F9 and 'Assemble.ced' to F10.
  69.  
  70.  
  71.  4. USAGE
  72. ----------
  73.  
  74. Load  the  source  file  you  want  to  assemble into CED.  When you want to
  75. assemble   the   file,  press  F10  (or  the  key  that  you  have  assigned
  76. 'Assemble.ced'  to)  while  CED's  active  view  is one of the views of your
  77. source file.  If you made some changes to the source file you do not need to
  78. save before, 'Assemble.ced' does this automatically if the number of changes
  79. displayed in the view's title is not equal to 0.
  80.  
  81. 'Assemble.ced'  now  invokes  Basm.   If  no  errors occured you will get an
  82. apropriate  message.   If  there  were  errors  or  warnigs you are told and
  83. 'NextError.ced' is invoked automatically to display the first error/warning.
  84.  
  85. Subsequent   keypresses  on  the  'NextError.ced'  assigned  key  result  in
  86. displaying  the  next error/warning.  First all errors are shown, afterwards
  87. all warnings.
  88.  
  89. When all errors/warnings have been shown and you press 'NextError' again you
  90. will be asked if you want to assemble the source again.
  91.  
  92.  
  93.  5. LIMITATIONS
  94. ----------------
  95.  
  96. · The scripts don't yet handle multiple CygnusED instances.
  97.  
  98. · The  scripts  could handle language localizaton if I knew how to find out
  99.   the language CygnusEd is currently using (any status number for this?).
  100.  
  101.  
  102.  6. AUTHOR
  103. -----------
  104.  
  105. If you have any suggestions, ideas or bug reports, feel free to contact me
  106. (e-mail preferred). Gifts are welcome ;-).
  107.  
  108. Ulrich Flegel
  109. e-mail: flegel@ibr.cs.tu-bs.de
  110. irc:    Froody (#amigager)
  111. phone:  ++49-5307-5660
  112.  
  113.